home *** CD-ROM | disk | FTP | other *** search
/ El Mac 8 / El Mac 8.iso / Shareware / Comms. & Networking / WWWStat4Mac 1.1 / WWWStat4Mac Prefs < prev    next >
Encoding:
Text File  |  1996-03-25  |  11.5 KB  |  248 lines  |  [TEXT/R*ch]
  1. # --------------------------------------
  2. # WWWStat4Mac  © P.J.Hardman 1995-1996. email redpoint@kagi.com.
  3. #          Preferences file.
  4. # WWWStat4Mac is Shareware ($10). Don't forget to REGISTER your copy.
  5. # This file should be in the preferences folder in the system folder.
  6. # --------------------------------------
  7. # Any line that starts with a # is ignored. The program doesn't expect
  8. # to find the information below in the any order but it does help to keep things tidy. 
  9. # Each option has two parts. The option identifier and the argument. Please make sure 
  10. # that you have both of these parts as I can't guarantee what might happen if one is missing.
  11. #
  12. # Here we go!
  13. # First lets start with the basic file generation options.
  14. # What do you want the file to be called? This is just the default name that appears in
  15. # the programs Save Dialog or the filename if you have auto_save turned on.
  16. # Note that the file will be saved in the same directory/folder as the log file.
  17. #
  18. file_name statistics.html
  19. #
  20. # Do you want to automatically save the output file. This option means that a file with
  21. # the name file_name is created. If a file with this name already exists it is overwritten.
  22. # [on/off]. When a file is created automatically, it is saved in the SAME FOLDER as the log
  23. # file that you created it from.
  24. #
  25. auto_save off
  26. #
  27. # Which application would you like to have created the file? 
  28. # For example BBEdit is R*ch. SimpleText is ttxt.
  29. #
  30. file_creator R*ch
  31. #
  32. # Do you want the errors to be excluded?.For example if a file doesn't exist and the request 
  33. # fails then we don't add it to the list of files requested. 
  34. # However the site that tried to access the file will be included. [on/off]
  35. #
  36. exclude_errors on
  37. #
  38. # How many sites and files do you want to keep track of?
  39. # ••NOTE••. These two options are currently unimplemented.
  40. # A future version will use these to dynamically allocate the required memory.
  41. # 
  42. max_sites 2000
  43. max_files 500
  44. #
  45. # The output file will always contain, as a bare minimum, a summary of the server traffic.
  46. # Including the no.hits, no. sites, no. files and total bytes transfered. 
  47. # However the next 4 options can be added as needed. [on/off]
  48. # 1. Site Statistics. (Show the top N sites or all if N=0).
  49. # -------------------
  50. #
  51. site_stats on
  52. #
  53. # 2. File Statistics. (Show the top N files or all if N=0).
  54. # -------------------
  55. #
  56. file_stats on
  57. #
  58. # 3. Robot Statistics. This attempts to list all the net robots,spiders and search
  59. # engines that have accessed your server and requested the file robots.txt
  60. #
  61. robot_stats off
  62. #
  63. # 4. Domain Statistics. This makes a list of hits and bytes transfered to each of the domains.
  64. # The domain list came from the following URL:
  65. # http://www.ics.uci.edu/WebSoft/wwwstat/country-codes.txt.
  66. # If you need to make additions to the file these can be added in the STR# resource ID 129.
  67. #
  68. domain_stats off
  69. #
  70. #
  71. # Traffic Statistics.
  72. # Do you want to see when your server is busiest? Which month had the most accesses? Which
  73. # day of the week sees the most hits? Then this is where you set these options.
  74. # If you want to collect statistics for the amount of traffic that you server is getting then
  75. # you can request data covering several time spans. You can look at the data by Hour of Day,
  76. # Day of Week,Day of Year, Week of Year, and by Month of Year. You can choose to have some or
  77. # all of these options on at the same time.
  78. #
  79. # traffic_stats hourly
  80. # traffic_stats daily
  81. # traffic_stats weekly
  82. # traffic_stats monthly
  83. # traffic_stats dayofyear  ••NOTE•• This option is unimplemented at this time
  84. #  
  85. #
  86. # How many sites and files do you actually want to show?
  87. # ••NOTE••. If you want show all of the sites/file then make these values 0.
  88. # ••NOTE••. If you have the output as tables (see later) then it is best to limit 
  89. # these values to less than 50. Otherwise browsers will require large amounts of memory to
  90. # display these tables.
  91. #
  92. top_sites 0
  93. top_files 0
  94. top_domains 0
  95. #
  96. # How do you want to sort the SITE data that is collected. You have five options 
  97. # [name/hits/bytes/date/visits].See later for info on how to specify a 'visit'.
  98. # Sort by name sorts alphabetically. By hits, bytes and visits sort in descending order.
  99. # By date sorts in reverse chronological order. So most recent sites come first.
  100. #
  101. sort_sites name
  102. #
  103. # How do you want to sort the file data that is collected. You have five options 
  104. # [name/hits/bytes/date/size].
  105. # Sort by name sorts alphabetically. By hits, bytes and size sort in descending order.
  106. # By date sorts in reverse chronological order. So most recent files come first.
  107. #
  108. sort_files bytes
  109. #
  110. # How do you want to sort the domain data that is collected. You have four options 
  111. # [name/hits/bytes/date].
  112. # Sort by name sorts alphabetically. By hits and bytes sort in descending order.
  113. # By date sorts in reverse chronological order. So most recent domains come first.
  114. #
  115. sort_domains hits
  116. #
  117. #    Now that you have defined what you want in the output file in the way of sites/files/domains
  118. # it is now time to FINE TUNE the analysis of the information.
  119. #
  120. # Inclusions. This option allows you to define in the next section up to 
  121. # 50 sites and 50 files that you would like to explicitly include in the output. You might
  122. # want to do this because you only want to look at a portion of your statistics file.
  123. # You can later exclude any files that are included here, but that you don't want to show
  124. # in the final result. For example gifs.
  125. # ••NOTE••.ANY SITE OR FILE THAT IS NOT INCLUDED WILL BE EXCLUDED. 
  126. #
  127. # First list each SITE that you want to INCLUDE on a separate line.
  128. # Make sure that there is only one space between inclusion and the sitename.
  129. # Don't forget to include the IP address in case the DNR resolver isn't active.
  130. # Wildcards are also supported at either the beginning or end of a string but not 
  131. # in the middle.
  132. #
  133. # site_inclusion your.host.machine.here
  134. # site_inclusion 1.2.3.4
  135. # site_inclusion *.com   include all US commercial sites
  136. #
  137. # Now list each FILE that you want to include on a separate line.
  138. # NOTE. Don't forget that you need to supply the full path name for the file as it would 
  139. # appear in the access log. These files are not case sensitive, as we convert all file
  140. # names to lowercase before comparing them.
  141. # Wildcards are also supported at either the beginning OR end of a string but not 
  142. # in the middle.
  143. #
  144. # file_inclusion *.gif  This would include all of the gif images.
  145. #
  146. # 6. Exclusions. This option allows you to define in the next section up to 
  147. # 50 sites and 50 files that you would like EXCLUDING from the output. You might
  148. # want to do this to stop some private files from being display in the statistics file.
  149. # Or to stop accesses from your own machine being added during heavy testing sessions. 
  150. # If a file is excluded then it's data is not added to the grand total and it is not included
  151. # in the total number of accesses.
  152. #
  153. # NOTE: If you want to exclude not only the site but also the files that it is accessing then
  154. # set the site_and_file option to on. Otherwise the site will be excluded but the file that was 
  155. # accessed will still be counted.
  156. #
  157. site_and_file off
  158. #
  159. # Now list each SITE that you want to EXCLUDE on a separate line.
  160. # ••NOTE•• Make sure that there is only one space between exclusion and the sitename.
  161. # Don't forget to include the IP address in case the DNR resolver isn't active.
  162. # Wildcards are also supported at either the beginning or end of a string but not 
  163. # in the middle.
  164. #
  165. # site_exclusion your.host.machine.here
  166. # site_exclusion 1.2.3.4
  167. # site_exclusion *.com   this would exclude all US commercial sites
  168. #
  169. # Now list each FILE that you want to exclude on a separate line.
  170. # NOTE. Don't forget that you need to supply the full path name for the file as it would 
  171. # appear in the access log. These files are not case sensitive, as we convert all file
  172. # names to lowercase before comparing them.
  173. # Wildcards are also supported at either the beginning or end of a string but not 
  174. # in the middle.
  175. #
  176. # file_exclusion *.gif This would exclude all of the gif images.
  177. file_exclusion /statistics.html
  178. file_exclusion /robots.txt
  179. #
  180. #    Misc Options.
  181. # •••••••••••••
  182. # Default File Mapping.
  183. # When a request is made to the server and there is no file defined then this goes into the log
  184. # as a request for /. But this is the same as requesting the default file so we can make hits 
  185. # on / look like hits on the default file. The default file is specified as the argument to
  186. # this option. This replaces the old option map_default_to_home since not all servers have
  187. # home.html as the default file. If the old option is used this automatically calls the 
  188. # map_default_to_file option with the argument /home.html
  189. #
  190. map_default_to_file /home.html
  191. #
  192. # Custom Domains.
  193. # If you want to add your own custom domains these can be specified by adding the new_domain
  194. # option followed by the partial string that need matching. It is important that the whole
  195. # option is in a single string. So for example :-
  196. #
  197. # new_domain Apple_Computer.apple.com.
  198. #            |<-  All One String   ->|
  199. #  where .apple.com. is the string that is matched. Any 
  200. # sites ending like this will then be added to the domain called Apple_Computer.
  201. # There is a limit of 40 custom domains, but this should be more than enough :-)
  202. #
  203. # Calculating Visits
  204. # More often than not a site will access the server and retrieve a collection of files. This 
  205. # set of files can be thought of as a single "visit" to the server. To define each "visit" we 
  206. # need to set a time between hits that we would expect to to occur in a single visit. So if you
  207. # are serving large text files that need a while to read then set your visit time to be quite
  208. # high. If on the other hand you are serving small text files or small graphics then you might
  209. # want a small visit time. The time is defined in SECONDS. Default time is 300s (ie 5 mins).
  210. #
  211. visit_time 300
  212. #
  213. # Domain Name Resolving
  214. # Version 1.1 adds the ability to resolve names using the domain name system. This gives you
  215. # the opportunity to resolve names that were not resolved by the web-server either because the 
  216. # DNS was down, too slow, or turned off. You need to do two things to get this working.
  217. # First set the resolve_names on or off. Then set the resolve_time to a value in seconds that
  218. # you wish to wait for the DNS to return. If you set the time to 0 then the application will 
  219. # wait until the DNS returns or fails to find a name. Be warned however that this could take up
  220. # to 120 seconds per item!!!!
  221. #
  222. resolve_names off
  223. resolve_time  10
  224. #
  225. # Active Links.
  226. # Do you want the files that are listed in the output to have active links that can be chosen
  227. # in the web browser? This means that someone can look at the stats file and then jump to the
  228. # most popular pages directly.
  229. # If so then turn this option on. Otherwise the files will not be accessible directly from
  230. # the stats file.
  231. # 
  232. active_links off
  233. # 
  234. # Create Tables?
  235. # If you want your output to consist of Tables rather than a simple text file then leave this
  236. # option off. Otherwise turn it on to get stunning tables :-) Of course you need a browser 
  237. # capable of displaying tables for example Netscape Navigator or Microsoft's Internet Explorer.
  238. #
  239. create_tables off
  240. #
  241. # ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  242. # ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  243. # If there are any problems with this file or you find something that is not explained 
  244. # fully then please drop me a line.
  245. # Peter Hardman   email redpoint@kagi.com
  246. # ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  247. # ••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  248.